home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / dbase / pdbase12.lha / PDBase / Help / Fran軋is / Aminet2PDB.readme next >
Text File  |  1995-05-06  |  3KB  |  67 lines
  1.          ____           __                  __   ____   ______ ____   ____
  2.         / __ \         /_/                _/ /_ /___ \ / __  // __ \ / __ \
  3.        / /_/ /_   _   __   ______ ______ /  __/____/ // /_/ // / / // /_/ /
  4.       / __  // \_/ \ / /  / __  // ____/ / /  / ____// ____// / / // __  /
  5.      / / / // /__/ // /_ / / / // __/_  / /_ / /___ / /    / /_/ // /_/ /
  6.     /_/ /_//_/  /_//___//_/ /_//_____/ /___/ \____//_/    /_____//_____/
  7.  
  8.                             - Aminet2PDB 1.0 -
  9.  
  10.                      (Copyright ©1995 Cédric Souchon)
  11.  
  12.  
  13.  
  14.    Aminet2PDB est un utilitaire destiné au CLI uniquement, qui vous permet
  15. de créer une arborescence aminet pour PDBase à partir d'un fichier INDEX
  16. standard pour aminet.
  17.  
  18.    Une arborescence aminet récente au format PDBase est fournie dans la
  19. distribution de PDBase, elle peut servir de base de départ pour la création
  20. d'une base de données de vos domaines publics.
  21.  
  22.    Le modèle d'arguments d'Aminet2PDB est:
  23.  
  24.    INDEX/A,PDBFILE/A,TREE/S
  25.  
  26. * INDEX   : Nom d'un fichier INDEX standard.
  27. * PDBFILE : Nom du fichier PDBase à créer.
  28. * TREE    : Lorsque ce commutateur est mis, l'arborescence du fichier INDEX
  29.             est affichée sur la sortie standard avant d'être sauvée en
  30.             fichier PDBase.
  31.  
  32.  
  33.    Note sur le format de l'INDEX:
  34.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.    Un utilitaire qui manipule des fichiers textes classiques pose toujours
  36. des problèmes, le format n'étant pas aussi rigoureux qu'un fichier binaire
  37. (par exemple l'IFF). Voici ce qu'attend Aminet2PDB comme format de fichier
  38. INDEX:
  39.  
  40.    Tout d'abord, Aminet2PDB recherche l'entête de l'INDEX qui est une suite
  41. de lignes commençant par le caractère: '|'. Il commence la construction de
  42. l'arborescence juste après cette entête (qui est obligatoire) en ignorant
  43. les lignes vides. La fin du travail est marqué par la fin du fichier ou
  44. trois tirets consécutifs en début de ligne: '---'.
  45.  
  46.    Le format de chaque ligne significative est le suivant: un nom de
  47. fichier en début de ligne SANS ESPACE, suivit d'un nombre quelconque
  48. d'espace puis du chemin aminet contenant un ou deux répertoires (pas plus)
  49. séparés par un caractère: '/'. Le reste de la ligne est ignoré, donc il
  50. peut y avoir n'importe quoi.
  51.  
  52.    Si ce format n'est pas respecté, le résultat peut être surprenant.
  53. Aminet2PDB contient toutefois le plus de protections possible (dans le
  54. domaine du raisonnable) pour éviter des gros problèmes, comme un plantage.
  55. Il détecte en partie les fichiers binaires et les fichiers textes non
  56. valides quand c'est possible. Normallement au pire, le résultat sera
  57. étonnant (des répertoires étranges dans PDBase). La plupart du temps,
  58. Aminet2PDB renverra une erreur dans le cas d'un INDEX non valide. Evitez
  59. malgrè tout de lui donner n'importe quoi en tant que fichier INDEX.
  60.  
  61.    Le système d'analyse du fichier INDEX admet toutefois toutes les formes
  62. que je connaisse, de l'INDEX complet aux INDEX quotidiens ou hebdomadaires
  63. postés sur les réseaux. Dans ce dernier cas, Aminet2PDB s'affranchit sans
  64. problème des entêtes réseaux et de la signature en bas de message (pourvu
  65. qu'elle soit précédée des trois tirets en début de ligne: '---').
  66.  
  67.